Skip to content

Polish public documentation and add accurate README badges - #4

Merged
Brendan-Lim merged 1 commit into
mainfrom
docs/public-repository-polish
Nov 9, 2026
Merged

Brendan-Lim merged 1 commit into
mainfrom
docs/public-repository-polish

Conversation

@Brendan-Lim

@Brendan-Lim Brendan-Lim commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

The public docs contain superseded implementation diaries, contradictory screenshot/readiness claims and obsolete candidate hashes. This removes those reports, consolidates useful procedures into maintained guides and adds five restrained, accurate README badges.

  • Obsolete documents: remove 12 historical/internal reports after inspecting all 94 tracked documentation files. Original reports and unused media are preserved privately outside Git. Keep research methodology, contributor specifications, agent guides and all executable fixtures, including Benchmarks/reports/browser-evidence/.
  • References and procedures: update release, permissions, capture and testing guides; preserve export/source-binding, validator budgets, cancellation and filesystem boundaries; fix stale links and add maintainer navigation. Replace the old installer illustration with the existing approved Light/Dark Finder screenshots. Remove four unused historical media files.
  • README badges: static Swift, macOS 14+ deployment target and Apple Silicon arm64; dynamic GitHub MIT license and real CI status for main, linked to ci.yml. External URLs return HTTP 200. GitHub-rendered markup passes desktop/mobile, Light/Dark and 1×/2× checks with all images decoded and no page overflow.
  • Policy maintenance: none. Publication approvals remain for historical audit; release-input policy and guard are unchanged. All seven genuine Retina screenshots remain byte-for-byte equal to main, with the same approved hashes, dimensions, aspect ratios and README widths.

Validation: full local scripts/ci.sh passed (117 Swift tests, 80 script tests, 49 benchmark tests, 13 independent schema/package checks, 10 replays, 10 broken/10 good browser controls, optimized build and ZIP/DMG verification). Staged/current/full reachable-history publication audits, public links and pinned Gitleaks pass. Hosted CI 42607656225 and Publication Security 42607656080 both passed on PR head 0103065a4ca04580c50af555d0b03dd17cb1e7cc / merge preview 952ae7084f22884a6a8ce2bbf8be1dbd4180885d. All 41 remaining documentation and badge-proxy URLs returned HTTP 200. The PR is mergeable, with auto-merge disabled.

Release consequence: candidate run 42601149595 at d0323bb84c08d5f42c29cae5635931bf2d825d98 passes freshness against current main. The unchanged guard rejects this PR head: “Release inputs changed after candidate preparation; prepare and test a new candidate”. Protected changes include root contributor/security/agent guides, installer README, the Hand Off report deletion and four media deletions. After integration, prepare and independently verify a new official candidate and repeat applicable exact-byte engineering acceptance. Existing 14-case observations remain historical regression evidence; five human security cases remain pending. No passing acceptance record is created.

No production code, tests, schemas, scripts, workflows, version metadata, Homebrew files or candidate artifacts changed. No release or tag was published. Review only: do not auto-merge or dispatch a new prepare workflow as part of this PR.

@Brendan-Lim
Brendan-Lim merged commit b4453ba into main Nov 9, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant